Range

Function

This API is used to get the parameter range of Event Settings(cloud dedicated) > Notification.

Note:

The Range provides reference information for client UI input limits and API request limits. When sending Get and Set requests, the parameters must be strictly limited according to the Range, otherwise the request may be rejected by the device.

Request Message

Table 1

ParameterRangeTypeDescription
channel"CH1"...stringCorresponding intelligent channel.
abilities"FaceDetection",
"HumanVehicle",
"LicensePlate",
"LineCrossing",
"Intrusion",
"Intrusion",
"ExitRegion",
"ObjectDetection",
"CrossCounting",
"CrossCounting",
"QueueLength",
"CrowdDensity",
"RareSound",
"MotionDetection",
"VideoTampering"
arrayCurrent intelligence.

Sampel:

POST /API/Event/AlarmLinkage/Range HTTP/1.1
{
    "version": "1.0",
    "data": {
        "channel": "CH1",
        "ability": "HumanVehicle"
    }
}

Response Message

Parameter Description

Table 2

ParameterRangeTypeDescription
channel_infoJSON ObjectChannel Info Object,see Table 3 for more information.

Table 3

Channel Info Object

ParameterRangeTypeDescription
CH1Json ObjectChannel Object,see Table 4 for more information.
IP_CH1Json Object
WIFI_CH1Json Object

Table 4

Channel Object

ParameterRangeTypeDescription
notification_settingsJson Objectnotification_settings Object,see Table 5 for more information.

Table 5

notification_settings Object

ParameterRangeTypeDescription
URL1Json ObjectURL Object,see Table 6 for more information.
URL2Json ObjectURL Object,see Table 6 for more information.
URL3Json ObjectURL Object,see Table 6 for more information.

Table 6

URL Object

ParameterRangeTypeDescription
enableboolPush switch.
push_way"HTTP",
"HTTPS"
stringPush protocol.
trigger_interval0 ~ 900intThe interval time for alarm linkage push.
method"GET",
"POST"
stringPush method.
url0 ~ 511stringThe network address to push.
username0 ~ 63stringUsername Account.
password0 ~ 63stringPassword.
password_emptyboolIs the password empty.
auth_enableboolIs user authentication enabled.
btn_get_default_databoolWhether to display the Get Defaults button.
limit_character" "stringRestricted characters.
base_enc_passwordJson Objectencrypted password,see base_secondary_authentication for more information.

Tips:

The response message of the Range request may not contain all the fields in the above table, and the fields not included indicate that the device does not support this parameter configuration.

Sample:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "result": "success",
    "data": {
        "channel_max": 8,
        "channel_info": {
            "type": "object",
            "items": {"CH1": {
                "type": "object",
                "items": {"notification_settings": {
                    "type": "object",
                    "items": {
                        "URL1": {
                            "type": "object",
                            "items": {
                                "enable": {"type": "bool"},
                                "push_way": {
                                    "type": "string",
                                    "items": [
                                        "HTTP",
                                        "HTTPS"
                                    ]
                                },
                                "trigger_interval": {
                                    "type": "int32",
                                    "min": 0,
                                    "max": 900
                                },
                                "method": {
                                    "type": "string",
                                    "items": [
                                        "GET",
                                        "POST"
                                    ]
                                },
                                "url": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 511
                                },
                                "username": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 63
                                },
                                "password": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 63
                                },
                                "password_empty": {"type": "bool"},
                                "auth_enable": {"type": "bool"}
                            }
                        },
                        "URL2": {
                            "type": "object",
                            "items": {
                                "enable": {"type": "bool"},
                                "push_way": {
                                    "type": "string",
                                    "items": [
                                        "HTTP",
                                        "HTTPS"
                                    ]
                                },
                                "trigger_interval": {
                                    "type": "int32",
                                    "min": 0,
                                    "max": 900
                                },
                                "method": {
                                    "type": "string",
                                    "items": [
                                        "GET",
                                        "POST"
                                    ]
                                },
                                "url": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 511
                                },
                                "username": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 63
                                },
                                "password": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 63
                                },
                                "password_empty": {"type": "bool"},
                                "auth_enable": {"type": "bool"}
                            }
                        },
                        "URL3": {
                            "type": "object",
                            "items": {
                                "enable": {"type": "bool"},
                                "push_way": {
                                    "type": "string",
                                    "items": [
                                        "HTTP",
                                        "HTTPS"
                                    ]
                                },
                                "trigger_interval": {
                                    "type": "int32",
                                    "min": 0,
                                    "max": 900
                                },
                                "method": {
                                    "type": "string",
                                    "items": [
                                        "GET",
                                        "POST"
                                    ]
                                },
                                "url": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 511
                                },
                                "username": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 63
                                },
                                "password": {
                                    "type": "string",
                                    "min_len": 0,
                                    "max_len": 63
                                },
                                "password_empty": {"type": "bool"},
                                "auth_enable": {"type": "bool"}
                            }
                        }
                    }
                }}
            }}
        },
        "btn_get_default_data": true,
        "limit_character": [
            " ",
            "
"
        ]
    }
}

Error Code

See Response Messages Body and Common error_code for more information.